Stockholm date 1991-02-27 page 1(8) QTHLOC v 4.2 description Copyright 1991 Curt Lundstedt, SM0GCW QTH - Locator and contest program ================================= TABLE OF CONTENTS 1 Common ...................................................... 2 1.1 Program copy and distribution conditions .................... 2 1.2 A worldwide QTH-locator system designed for HAM-radio. ...... 2 1.3 Files QTHLOC produce or use ................................. 3 2 Useful features ............................................. 3 2.1 Determination of QTH-locator ................................ 3 2.2 Convert QTH-locator to longitude and latitude ............... 4 2.3 Calculate direction and distance from QTH-locator ........... 4 2.4 Calculate direction and distance from longitude and latitude 4 3 Contest-log making .......................................... 5 3.1 Common ...................................................... 5 3.2 HF VHF UHF SHF - contest .................................... 5 3.3 "Free format" - contest ..................................... 6 3.4 Define new command rule ..................................... 6 3.5 Personal setup data ......................................... 7 3.6 Printer function ............................................ 7 3.7 Packet radio conversion function ............................ 8 Stockholm date 1991-02-27 page 2 QTHLOC v 4.2 description Copyright 1991 Curt Lundstedt, SM0GCW 1 Common This program will help you with the boring job to make contest-log. It will also help you to calculate distance and direction between to QTH:s. You can give input as QTH-locator or as longitude and latitude. The Program convert longitude and latitude to QTH-locator and the reverse is of course possible. This program is possible to run in both English (default) and Swedish language. 1.1 Program copy and distribution conditions This program may be copied and distributed under this conditions: A. No fee is charged for its distribution. B. It must be distributed without modification. C. It may not be distributed by commercial firms without permission. If you find this program of use, a contribution of $10 ( or 50 Swedish kronor) will be helpful to make new and better versions of this program and new programs. Author : Curt Lundstedt, SM0GCW address : Orvar Odds vag 10 S-112 54 STOCKHOLM SWEDEN If you write to me and want to have answer. You must send an envelope with your name and address + postage. You can also write to me on packet mailbox SM0GCW@SM0ETV or SM0GCW@SM5BKI. 1.2 A worldwide QTH-locator system designed for HAM-radio. The earth's surface is divided into 18*18=324 "FIELDS", 20 degrees longitude and 10 degrees latitude. Each field is divided into 10*10= 100 "SQUARES", 2 degrees longitude and 1 degrees latitude. Finally each square is divided into 24*24=576 "SUBSQUARES", 5 minutes longitude 2.5 minutes latitude. The fields are given by 2 letters AA - RR. The squares by 2 digits 00 - 99. The subsquares by 2 letters AA - XX. The first character gives the longitude and the second character gives the latitude on each level. A complete locator are 6 character long. Example 59 degrees North, 18 degrees East, give locator JO99AA Reference literature: The Radio Amateur's World Atlas by SM5AGM SSA, Ostmaksgatan 43 S-123 42 FARSTA SWEDEN Stockholm date 1991-02-27 page 3 QTHLOC v 4.2 description Copyright 1991 Curt Lundstedt, SM0GCW 1.3 Files QTHLOC produce or use QTHLOC.EXE The QTHLOC program started under MS-dos QTHLOC.CNF Contain your personal data. Station, antenna ... QTHLOC.DCL Define commands for your favorite contest. This file must be edit by your self. QTHLOCEN.HLP Contain help text, and message. Written in English. QTHLOCSW.HLP Contain help text, and message. Written in Swedish. QTHREC.REC Records of QSO data. QTHREC.BAK Backup of latest deleted QSO data, you can rename the file and use it again if you need. Try to use this file if you have deleted QTHREC.REC by mistake. xdate.PRI Contest-log ready to print on your line-printer xdate.BAK Backup of contest-log ( x = type of test, H HF, V VHF, U UHF, S SHF date = contest date ) xdate.PAC 7 bit ASCII converted file for Packet radio DESCRIPT.TXT This file. BESKRIVN.TXT Swidish description. 2 Useful features 2.1 Determination of QTH-locator Look in a good map for your exact possition. You enter your longitude and latitude. Western longitude and southern latitude should be entered as negative values. Example 1 18 degrees 2 minutes East longitude and 59 degrees 18 minutes 40 seconds North latitude should be entered as 18 2 0 and 59 18 40. The result will be JO99AH Example 2 117 degrees 5 minutes West and 34 degrees 25 minutes North should be entered as -117 -5 0 and 34 25 0. The result will be DM14KK Stockholm date 1991-02-27 page 4 QTHLOC v 4.2 description Copyright 1991 Curt Lundstedt, SM0GCW 2.2 Convert QTH-locator to longitude and latitude You enter the QTH-locator. The program will calculate and give you longitude and latitude. Western longitude and southern latitude is given as negative values. Example DM14LK The result will be -117,-5 degrees longitude and 34,25 degrees latitude. (117 degrees 5 minutes West and 34 degrees 25 minutes North) 2.3 Calculate direction and distance from QTH-locator Give the QTH-locator of the starting point and the point you will calculate. The program calculate and give you answer. Example 1 JO99AH to KO03DX give 608 km and 166 degrees. Example 2 DM14LK to GG66MA give 9834 km and 121 degrees. 2.4 Calculate direction and distance from longitude and latitude Give your longitude and latitude of the starting point and the point will calculate. The program calculate and give you answer. Western longitude and southern latitude should be entered as negative values. Example 1 18 degrees East, 59 degrees 18 minutes North to 20 degrees 15 minutes East, 53 degrees 58 minutes North give 607.7 km and 166 degrees Example 2 117 degrees 5 minutes Vest, 34 degrees 25 minutes North 47 degrees vest, 24 degrees South ( you write -117 -5 0 , 34 25 0 and -47 0 0 , -24 0 0 ) give 9836.9 km and 121 degrees Stockholm date 1991-02-27 page 5 QTHLOC v 4.2 description Copyright 1991 Curt Lundstedt, SM0GCW 3 Contest-log making 3.1 Common Before you start enter the QSO-data for the contest, the configuration data must bee entered. This data is only entered the first time when you use this program or when your equipment is changed. You have 5 different commands to use when you calculate your contest-log. In the "free-format" command can you order very different types of score calculation. The other 4 commands is predefined for your favorite contests. Read more about how to do predefined command in 'define new command rule'. When you have made your choice, the QSO-entering can be started. You simply answer the questions. If you make anything wrong, use the up-, down-arrow or the rubout or insert command. With the arrow-keys you also can step to next QSO before or after. When you have entered all QSO press Esc or ctrl-c to continue to next step. If you have a file of QSO already stored on disk the program ask if you want to delete it. Don't be afraid, if you say Y the program store the old QSO-data under the name QTHREC.BAK (backup). 3.2 HF VHF UHF SHF - contest You have four definable command for contest-log making. Default for this commands ( without QTHLOC.DCL file) is "Swedish rules for m†nadstest". You can easy define the rule for your favorite contest, see 'Define new command rule'. First, you enter your QSO-data. You simply answer the questions. If you make anything wrong, use the up-, down-arrow or the rubout or insert command. With the arrow-keys you also can step to next QSO before or after. When you have entered all QSO press Esc or ctrl-c to continue to next step. If you have a file of QSO already stored on disk the program ask if you want to delete it. Don't be afraid, if you say Y the program store the old QSO-data under the name QTHREC.BAK (backup). After that, you give the name of the contest and date for the contest. When all data is entered the program produce the contest-log. Stockholm date 1991-02-27 page 6 QTHLOC v 4.2 description Copyright 1991 Curt Lundstedt, SM0GCW 3.3 "Free format" - contest With this command it is possible to "program" your own contest-rules. Answer the questions on screen. Then press enter, escape or ctrl-c. The first question ask for one or more letter, A-I. A one point per Km distance. B one point per Km distance ( if > 2000 km = 2000 points ). C one point per 10 Km distance. D multiply factor * point per square. E multiply factor * point per Call-prefix ( two first characters ). F add factor * point per square to the total sum. G add factor * point per Call-prefix to the total sum. H multiply with every 100 MHz ( 144 give 1 point, 432 give 4 ...) I multiply with every GHz ( 2304 give 2 point, 10368 give 10 ...) In some combinations you can add an bonus factor. At last you enter name of the contest and type of test. Example 1 C Give you one point per 10 km distance ( km is rounded up to next km ) Example 2 F Give you one point per worked square. You can also ad bonus points per square. Example 3 AE factor 20 Give you one point per km multiply with 20 points per Call-prefix. Example 4 AI Give you one point per km multiply with number of GHz, a QSO on 2304 GHz and 65 km give 2 * 65 = 130 points. 3.4 Define new command rule How to make commands for your favorite contest. You make a file with your ordinary editor. The file must be named QTHLOC.DCL . The file shall contain 4 lines. Line 1 HF, line 2 VHF, line 3 UHF, line 4 SHF. Each line shall have one or more letter just like 'free-format' command. After the letter you can add a bonus factor. A one point per Km distance. B one point per Km distance ( if > 2000 km = 2000 points ). C one point per 10 Km distance. D multiply factor * point per square. E multiply factor * point per Call-prefix ( two first characters ). Stockholm date 1991-02-27 page 7 QTHLOC v 4.2 description Copyright 1991 Curt Lundstedt, SM0GCW F add factor * point per square to the total sum. G add factor * point per Call-prefix to the total sum. H multiply with every 100 MHz ( 144 give 1 point, 432 give 4 ...) I multiply with every GHz ( 2304 give 2 point, 10368 give 10 ...) Example: HF one point per km multiplication with one point per call-pref. VHF one point per km and 400 points per square. UHF one point per km with limits. UHF one point per km mult. with number of GHz for each QSO File: AE AF 400 B AI 3.5 Personal setup data Enter data about yourself and your station. Enter also number of line on your line-printer ( paper length) and the color on screen. This data is stored on disk and you need only to work with it when something is changed. If you have problem with your screen or if you want to change color this color are valid: 0 : Black, 1 : Blue, 2 : Green, 3 : Cyan, 4 : Red, 5 : Magnenta 6 : Brown, 7 : Gray, 8 : Lightgray, 9 : LightBlue, 10 : LightGreen 11 : Lightcyan, 12 : Lightred, 13 : Lightmagenta, 14 : Yellow, 15 : White. If you have black and white screen try with color text = 15, color background = 0 and color field = 0. This program can also be changed to Swedish language in the setup screen. Default is English language. 3.6 Printer function This function use normal LPT1 output. You can use a editor to change the log-file. If you have a unusual printer use your own print-program direct to xdate.PRI file ! You can also send this file to your contest-manager via packet radio. The first letter in file name depend on type of test: V = VHF U = UHF S = SHF H = HF The rest of the name is date for the test. Stockholm date 1991-02-27 page 8 QTHLOC v 4.2 description Copyright 1991 Curt Lundstedt, SM0GCW 3.7 Packet radio conversion function This function is useful in northern countries using special letter '†„” ¸ˇ™ ...'. This letter must be converted to 7 bit ASCII before you can send it via packet radio.